// 14.2内容, 使用三斜线/// 进行文档注释

// 外层条目
//! # My Crate
//! this is my test


/// Adds one to the number given.
/// # Examples
/// 
/// ```
/// let arg = 4;
/// let answer = myCrate::add_one(arg); // 注意,这里要加上crate名字, 在Cargo.toml中获得或者修改
/// assert_eq!(5, answer);
/// ```

pub fn add_one(num: i32) -> i32 {
    num + 1
}

// 写完以上内容后, 通过 cargo doc --open 命令生成文档, 并在浏览器中查看

// 除了Examples这个章节之外, 还有Errors, Panics, Safety 等等
// 我们执行cargo test可以自动测试章节中的例子;